Key Features¶

You can try out leafmap by using Goolge Colab or Binder without having to install anything on your computer.

Install leafmap¶

In [1]:

import os
import subprocess

import os import subprocess

In [2]:

try:
    import leafmap
except ImportError:
    print('Installing leafmap ...')
    subprocess.check_call(["python", '-m', 'pip', 'install', 'leafmap'])

try: import leafmap except ImportError: print('Installing leafmap ...') subprocess.check_call(["python", '-m', 'pip', 'install', 'leafmap'])

Use folium plotting backend¶

In [3]:

import leafmap.foliumap as leafmap

import leafmap.foliumap as leafmap

Use ipyleaflet plotting backend¶

In [4]:

import leafmap

import leafmap

Create an interactive map¶

In [5]:

m = leafmap.Map(center=(40, -100), zoom=4)
m

m = leafmap.Map(center=(40, -100), zoom=4) m

Out[5]:

Make this Notebook Trusted to load map: File -> Trust Notebook

Customize map height¶

In [6]:

m = leafmap.Map(height="400px", width="800px")
m

m = leafmap.Map(height="400px", width="800px") m

Out[6]:

Set control visibility¶

In [7]:

m = leafmap.Map(
    draw_control=False,
    measure_control=False,
    fullscreen_control=False,
    attribution_control=True,
)
m

m = leafmap.Map( draw_control=False, measure_control=False, fullscreen_control=False, attribution_control=True, ) m

Out[7]:

Make this Notebook Trusted to load map: File -> Trust Notebook

Change basemaps¶

In [8]:

m = leafmap.Map()
m.add_basemap("Esri.NatGeoWorldMap")
m

m = leafmap.Map() m.add_basemap("Esri.NatGeoWorldMap") m

Out[8]:

Make this Notebook Trusted to load map: File -> Trust Notebook

Add XYZ tile layer¶

In [9]:

m = leafmap.Map()
m.add_tile_layer(
    url="https://mt1.google.com/vt/lyrs=y&x={x}&y={y}&z={z}",
    name="Google Satellite",
    attribution="Google",
)
m

m = leafmap.Map() m.add_tile_layer( url="https://mt1.google.com/vt/lyrs=y&x={x}&y={y}&z={z}", name="Google Satellite", attribution="Google", ) m

Out[9]:

Make this Notebook Trusted to load map: File -> Trust Notebook

Add WMS tile layer¶

In [10]:

m = leafmap.Map()
naip_url = 'https://services.nationalmap.gov/arcgis/services/USGSNAIPImagery/ImageServer/WMSServer?'
m.add_wms_layer(
    url=naip_url, layers='0', name='NAIP Imagery', format='image/png', shown=True
)
m

m = leafmap.Map() naip_url = 'https://services.nationalmap.gov/arcgis/services/USGSNAIPImagery/ImageServer/WMSServer?' m.add_wms_layer( url=naip_url, layers='0', name='NAIP Imagery', format='image/png', shown=True ) m

Out[10]:

Make this Notebook Trusted to load map: File -> Trust Notebook

Add COG layer¶

In [11]:

m = leafmap.Map()
url = 'https://opendata.digitalglobe.com/events/california-fire-2020/pre-event/2018-02-16/pine-gulch-fire20/1030010076004E00.tif'
m.add_cog_layer(url, name="Fire (pre-event)")
m

m = leafmap.Map() url = 'https://opendata.digitalglobe.com/events/california-fire-2020/pre-event/2018-02-16/pine-gulch-fire20/1030010076004E00.tif' m.add_cog_layer(url, name="Fire (pre-event)") m

Out[11]:

Make this Notebook Trusted to load map: File -> Trust Notebook

Add STAC layer¶

In [12]:

m = leafmap.Map()
url = 'https://canada-spot-ortho.s3.amazonaws.com/canada_spot_orthoimages/canada_spot5_orthoimages/S5_2007/S5_11055_6057_20070622/S5_11055_6057_20070622.json'
m.add_stac_layer(url, bands=['B3', 'B2', 'B1'], name='False color')
m

m = leafmap.Map() url = 'https://canada-spot-ortho.s3.amazonaws.com/canada_spot_orthoimages/canada_spot5_orthoimages/S5_2007/S5_11055_6057_20070622/S5_11055_6057_20070622.json' m.add_stac_layer(url, bands=['B3', 'B2', 'B1'], name='False color') m

Out[12]:

Make this Notebook Trusted to load map: File -> Trust Notebook

Add legend¶

In [13]:

m = leafmap.Map()
url = "https://www.mrlc.gov/geoserver/mrlc_display/NLCD_2016_Land_Cover_L48/wms?"
m.add_wms_layer(
    url,
    layers="NLCD_2016_Land_Cover_L48",
    name="NLCD 2016 CONUS Land Cover",
    format="image/png",
    transparent=True,
)
m.add_legend(builtin_legend='NLCD')
m

m = leafmap.Map() url = "https://www.mrlc.gov/geoserver/mrlc_display/NLCD_2016_Land_Cover_L48/wms?" m.add_wms_layer( url, layers="NLCD_2016_Land_Cover_L48", name="NLCD 2016 CONUS Land Cover", format="image/png", transparent=True, ) m.add_legend(builtin_legend='NLCD') m

Out[13]:

Make this Notebook Trusted to load map: File -> Trust Notebook

Add colorbar¶

In [14]:

m = leafmap.Map()
m.add_basemap('USGS 3DEP Elevation')
colors = ['006633', 'E5FFCC', '662A00', 'D8D8D8', 'F5F5F5']
vmin = 0
vmax = 4000
m.add_colorbar(colors=colors, vmin=vmin, vmax=vmax)
m

m = leafmap.Map() m.add_basemap('USGS 3DEP Elevation') colors = ['006633', 'E5FFCC', '662A00', 'D8D8D8', 'F5F5F5'] vmin = 0 vmax = 4000 m.add_colorbar(colors=colors, vmin=vmin, vmax=vmax) m

Out[14]:

Make this Notebook Trusted to load map: File -> Trust Notebook

Add GeoJSON¶

In [15]:

m = leafmap.Map(center=[0, 0], zoom=2)
in_geojson = 'https://raw.githubusercontent.com/giswqs/leafmap/master/examples/data/cable_geo.geojson'
m.add_geojson(in_geojson, layer_name="Cable lines")
m

m = leafmap.Map(center=[0, 0], zoom=2) in_geojson = 'https://raw.githubusercontent.com/giswqs/leafmap/master/examples/data/cable_geo.geojson' m.add_geojson(in_geojson, layer_name="Cable lines") m

Out[15]:

Make this Notebook Trusted to load map: File -> Trust Notebook

In [16]:

# Add a GeoJSON with random filled color to the map.
m = leafmap.Map(center=[0, 0], zoom=2)
url = "https://raw.githubusercontent.com/giswqs/leafmap/master/examples/data/countries.geojson"
m.add_geojson(
    url, layer_name="Countries", fill_colors=['red', 'yellow', 'green', 'orange']
)
m

# Add a GeoJSON with random filled color to the map. m = leafmap.Map(center=[0, 0], zoom=2) url = "https://raw.githubusercontent.com/giswqs/leafmap/master/examples/data/countries.geojson" m.add_geojson( url, layer_name="Countries", fill_colors=['red', 'yellow', 'green', 'orange'] ) m

Out[16]:

Make this Notebook Trusted to load map: File -> Trust Notebook

In [17]:

# Use custom style and hover_style functions.
m = leafmap.Map(center=[0, 0], zoom=2)
url = "https://raw.githubusercontent.com/giswqs/leafmap/master/examples/data/countries.geojson"
style = {
    "stroke": True,
    "color": "#0000ff",
    "weight": 2,
    "opacity": 1,
    "fill": True,
    "fillColor": "#0000ff",
    "fillOpacity": 0.1,
}
hover_style = {"fillOpacity": 0.7}
m.add_geojson(url, layer_name="Countries", style=style, hover_style=hover_style)
m

# Use custom style and hover_style functions. m = leafmap.Map(center=[0, 0], zoom=2) url = "https://raw.githubusercontent.com/giswqs/leafmap/master/examples/data/countries.geojson" style = { "stroke": True, "color": "#0000ff", "weight": 2, "opacity": 1, "fill": True, "fillColor": "#0000ff", "fillOpacity": 0.1, } hover_style = {"fillOpacity": 0.7} m.add_geojson(url, layer_name="Countries", style=style, hover_style=hover_style) m

Out[17]:

Make this Notebook Trusted to load map: File -> Trust Notebook

Add shapefile¶

In [18]:

m = leafmap.Map(center=[0, 0], zoom=2)
in_shp = 'https://github.com/giswqs/leafmap/raw/master/examples/data/countries.zip'
m.add_shp(in_shp, layer_name="Countries")
m

m = leafmap.Map(center=[0, 0], zoom=2) in_shp = 'https://github.com/giswqs/leafmap/raw/master/examples/data/countries.zip' m.add_shp(in_shp, layer_name="Countries") m

Downloading...
From: https://github.com/giswqs/leafmap/raw/master/examples/data/countries.zip
To: /home/runner/work/leafmap/leafmap/docs/notebooks/cache/shp/countries.zip
100%|██████████| 132k/132k [00:00<00:00, 32.4MB/s]

Extracting files...

Out[18]:

Make this Notebook Trusted to load map: File -> Trust Notebook

Add KML¶

In [19]:

try:
    import geopandas
except ImportError:
    print('Installing geopandas ...')
    subprocess.check_call(["python", '-m', 'pip', 'install', 'geopandas'])

try: import geopandas except ImportError: print('Installing geopandas ...') subprocess.check_call(["python", '-m', 'pip', 'install', 'geopandas'])

In [20]:

m = leafmap.Map()
in_kml = 'https://raw.githubusercontent.com/giswqs/leafmap/master/examples/data/us_states.kml'
m.add_kml(in_kml, layer_name="US States KML")
m

m = leafmap.Map() in_kml = 'https://raw.githubusercontent.com/giswqs/leafmap/master/examples/data/us_states.kml' m.add_kml(in_kml, layer_name="US States KML") m

Downloading...
From: https://raw.githubusercontent.com/giswqs/leafmap/master/examples/data/us_states.kml
To: /home/runner/work/leafmap/leafmap/docs/notebooks/us_states.kml
95.4kB [00:00, 74.7MB/s]                   

---------------------------------------------------------------------------
AttributeError                            Traceback (most recent call last)
Cell In [20], line 3
      1 m = leafmap.Map()
      2 in_kml = 'https://raw.githubusercontent.com/giswqs/leafmap/master/examples/data/us_states.kml'
----> 3 m.add_kml(in_kml, layer_name="US States KML")
      4 m

File /opt/hostedtoolcache/Python/3.9.13/x64/lib/python3.9/site-packages/leafmap/foliumap.py:1340, in Map.add_kml(self, in_kml, layer_name, info_mode, **kwargs)
   1337     if not os.path.exists(in_kml):
   1338         raise FileNotFoundError("The provided KML could not be found.")
-> 1340 data = kml_to_geojson(in_kml)
   1342 self.add_geojson(data, layer_name=layer_name, info_mode=info_mode, **kwargs)

File /opt/hostedtoolcache/Python/3.9.13/x64/lib/python3.9/site-packages/leafmap/common.py:2229, in kml_to_geojson(in_kml, out_geojson)
   2225 import geopandas as gpd
   2227 # import fiona
   2228 # print(fiona.supported_drivers)
-> 2229 gpd.io.file.fiona.drvsupport.supported_drivers["KML"] = "rw"
   2230 gdf = gpd.read_file(in_kml, driver="KML")
   2232 if out_geojson is not None:

AttributeError: 'NoneType' object has no attribute 'drvsupport'

Add GeoDataFrame¶

In [21]:

import geopandas as gpd

m = leafmap.Map()
gdf = gpd.read_file(
    "https://github.com/giswqs/leafmap/raw/master/examples/data/cable_geo.geojson"
)
m.add_gdf(gdf, layer_name="Cable lines")
m

import geopandas as gpd m = leafmap.Map() gdf = gpd.read_file( "https://github.com/giswqs/leafmap/raw/master/examples/data/cable_geo.geojson" ) m.add_gdf(gdf, layer_name="Cable lines") m

Out[21]:

Make this Notebook Trusted to load map: File -> Trust Notebook

Create heat map¶

In [22]:

m = leafmap.Map()
in_csv = "https://raw.githubusercontent.com/giswqs/leafmap/master/examples/data/world_cities.csv"
m.add_heatmap(
    in_csv,
    latitude="latitude",
    longitude='longitude',
    value="pop_max",
    name="Heat map",
    radius=20,
)

m = leafmap.Map() in_csv = "https://raw.githubusercontent.com/giswqs/leafmap/master/examples/data/world_cities.csv" m.add_heatmap( in_csv, latitude="latitude", longitude='longitude', value="pop_max", name="Heat map", radius=20, )

In [23]:

colors = ['blue', 'lime', 'red']
vmin = 0
vmax = 10000
m.add_colorbar(colors=colors, vmin=vmin, vmax=vmax)
m.add_title("World Population Heat Map", font_size="20px", align="center")
m

colors = ['blue', 'lime', 'red'] vmin = 0 vmax = 10000 m.add_colorbar(colors=colors, vmin=vmin, vmax=vmax) m.add_title("World Population Heat Map", font_size="20px", align="center") m

Out[23]:

Make this Notebook Trusted to load map: File -> Trust Notebook

Save map to HTML¶

In [24]:

m = leafmap.Map()
m.add_basemap("Esri.NatGeoWorldMap")
m

m = leafmap.Map() m.add_basemap("Esri.NatGeoWorldMap") m

Out[24]:

Make this Notebook Trusted to load map: File -> Trust Notebook

In [25]:

m.to_html("mymap.html")

m.to_html("mymap.html")

Add Planet imagery¶

In [26]:

# os.environ["PLANET_API_KEY"] = "12345"

# os.environ["PLANET_API_KEY"] = "12345"

In [27]:

m = leafmap.Map()
m.add_planet_by_month(year=2020, month=8)
m.add_planet_by_quarter(year=2019, quarter=2)
m

m = leafmap.Map() m.add_planet_by_month(year=2020, month=8) m.add_planet_by_quarter(year=2019, quarter=2) m

Out[27]:

Make this Notebook Trusted to load map: File -> Trust Notebook

Add OpenStreetMap data¶

Add OSM data of place(s) by name or ID to the map.

In [28]:

m = leafmap.Map(toolbar_control=False, layers_control=True)
m.add_osm_from_geocode("New York City", layer_name='NYC')
m

m = leafmap.Map(toolbar_control=False, layers_control=True) m.add_osm_from_geocode("New York City", layer_name='NYC') m

Out[28]:

Make this Notebook Trusted to load map: File -> Trust Notebook

Add OSM entities within boundaries of geocodable place(s) to the map.

In [29]:

m = leafmap.Map(toolbar_control=False, layers_control=True)
place = "Bunker Hill, Los Angeles, California"
tags = {"building": True}
m.add_osm_from_place(place, tags, layer_name="Los Angeles, CA")
m

m = leafmap.Map(toolbar_control=False, layers_control=True) place = "Bunker Hill, Los Angeles, California" tags = {"building": True} m.add_osm_from_place(place, tags, layer_name="Los Angeles, CA") m

Out[29]:

Make this Notebook Trusted to load map: File -> Trust Notebook

Use heremap plotting backend¶

• A HERE developer account, free and available under HERE Developer Portal
• An API key from the HERE Developer Portal
• Export API key into environment variable HEREMAPS_API_KEY

export HEREMAPS_API_KEY=YOUR-ACTUAL-API-KEY

In [30]:

import leafmap.heremap as leafmap

import leafmap.heremap as leafmap

Set the API Key.

In [31]:

# os.environ["HEREMAPS_API_KEY"] = "12345"

# os.environ["HEREMAPS_API_KEY"] = "12345"

In [32]:

api_key = os.environ.get("HEREMAPS_API_KEY")  # read api_key from environment variable.

api_key = os.environ.get("HEREMAPS_API_KEY") # read api_key from environment variable.

Create an interactive map

In [33]:

m = leafmap.Map(api_key=api_key, center=(40, -100), zoom=4)
m

m = leafmap.Map(api_key=api_key, center=(40, -100), zoom=4) m

---

Last update: 2022-09-07